home *** CD-ROM | disk | FTP | other *** search
/ Almathera Ten Pack 3: CDPD 3 / Almathera Ten on Ten - Disc 3: CDPD3.iso / scope / 101-125 / scopedisk106 / snag / snag.doc < prev    next >
Text File  |  1995-03-19  |  4KB  |  71 lines
  1. SNAG by Paul Falstad
  2.         5415 Abbott Place
  3.         Edina, MN 55410
  4.         PLink: HYPNOS
  5.         GEnie: P.FALSTAD
  6.         CIS: 70016,1355
  7.  
  8. This is a shoddily written but extremely useful program I wrote to help me
  9. remember to do things.  To use it, follow these steps:
  10.  
  11. 1. Write up a SNAG.DAT file, or modify the example file given, that contains
  12.    what you want SNAG to remind you of.  Read the example file.  Each entry
  13.    is in the following format:
  14.    
  15. [-----------41 char text field--------][--6 char date--][1 char modifier]
  16.  
  17.    If you need more than 41 characters, use two or more entries, as shown in
  18.    the "buy books" example in the example file.  The date is in the format
  19.    MM-DD-YY.  The modifier is optional.
  20.    
  21.    If no modifier is given, SNAG will remind you to do whatever the entry
  22.    specifies until you delete the entry from the file.  But if you do specify
  23.    a modifier, SNAG will display the entry and then increment the date.
  24.    Legal modifiers include:
  25.    
  26.    * weekly  ] daily  ! every other week  & yearly  ^ monthly
  27.    
  28.    For example, when SNAG reads an entry with * at the end, it will display it
  29.    and then increment the month.  You will not be reminded of the entry again
  30.    for another month.
  31.    
  32.    Put SNAG.DAT in your S: directory.
  33.    
  34. 2. Put SNAG in your startup-sequence.  You don't have to RUN it; it returns
  35.    immediately.
  36.  
  37. So from now on, when you boot the machine, SNAG will check the S:SNAG.DAT file
  38. to see if there's anything on your calendar for the day.  If so, it will open
  39. a screen and display all the entries pending for the day, and increment their
  40. dates if necessary.  Getting rid of the SNAG screen is difficult -- it's
  41. supposed to be.  To close it, either use ScreenX (a very useful utility), or
  42. use RudeFuncs' CloseScreen command (the address of the Screen structure is
  43. shown at the bottom of the screen).  Otherwise, just leave it in memory.
  44.  
  45. If there is anything on your calendar for the day that is not a periodic event
  46. (i.e. it doesn't have a modifier; it's not daily, weekly, monthly, etc.), SNAG
  47. will remind you to do it until you actually go in and edit the SNAG.DAT file.
  48. You can do one of two things: (1) delete the entry.  In this case, SNAG
  49. assumes that you've taken care of the matter, or that you will not forget, or
  50. that you don't care.  SNAG is not responsible if you delete the entry and then
  51. forget to take care of it.  If you delete the "buy books" entry and then
  52. forget to actually go out and buy books, I am not responsible.
  53. (2) procrastinate -- increment the date yourself.  This is not wise.
  54.  
  55. I assume that, if you use this program, you either set the date every day, or
  56. have a clock/calendar device.  Otherwise, it's not very useful, is it?
  57.  
  58. When an event is dated, for example, 02-01-90, it will be triggered if SNAG
  59. is run when the system date is greater than 3:00:00, Febuary 1, 1990.
  60. The 3 am cutoff is useful for people who stay up and hack late at night and
  61. don't like getting the next day's messages if they reboot after midnight.
  62. Dedicated hackers may want to increase the cutoff to 5 am or 11 am.
  63.  
  64. This program and its code are public domain.  I am not responsible for any
  65. damages caused indirectly by this program (or directly, for that matter).
  66. If somebody wants to take the time to go through and make this program easier
  67. to use (I'm too lazy), he may, on the sole condition that he send me a copy
  68. of his work (for my use).  I suggest, however, that you not make it TOO easy
  69. to make the screen go away, or to delete an entry.  For nagging to be
  70. effective, it should be hard to shut off.
  71.